home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / tools / system-tools / reboot / reboot.doc < prev    next >
Text File  |  1996-02-26  |  6KB  |  158 lines
  1.  
  2. /*
  3. **
  4. **  $VER: Reboot.doc 1.1 (17.9.95)
  5. **  Reboot 1.0
  6. **
  7. **  documentation
  8. **
  9. **  (C) Copyright 1994/1995 by Roland 'Gizzy' Mainz
  10. **          All Rights Reserved
  11. **
  12. */
  13.  
  14. =====================   Reboot 1.1 documentation   ========================
  15. ===========================================================================
  16. A   simple   tool   to  be  used   with  Kickstart 2.x/3.x,  written  by
  17.  Roland 'Gizzy' Mainz,  freeware, all rights reserved.
  18. No guarantee of any kind is made that  the programm described below in this
  19.  document is 100% reliable. You use this material on your own risk.
  20.  
  21.  
  22. =========================== Misc ==========================================
  23. ===========================================================================
  24. While playing with ENVOY 1.6, I need a program which allows to reboot
  25. another AMIGA through the network (by my own "RemoteNetShell") or
  26. after a given time.
  27. First I wrote a little script (using WAIT) and a C program calling
  28. exec.library/ColdReboot() to solve this problem.
  29. Switching to IAM's ENVOY 2.0 I replaced this script by this tool,
  30. adding some features (WB (including multiselect), SHELL ReadArgs(),
  31. locale support and test mode).
  32.  
  33.  
  34. =========================== Installation ==================================
  35. ===========================================================================
  36. After unpacking this archieve:
  37.  
  38. Workbench:
  39.   - Drop the 'Reboot' icon in your favorite drawer (like
  40.      "SYS:Utilities/").
  41.     See SHELL for copying the catalog files.
  42.  
  43. Shell:
  44.   - Unpack this archieve at "SYS:Utilities/"
  45.     and add the following statements at your "S:user-startup" startup file:
  46.  
  47.     Assign Reboot: SYS:Utilities/Reboot
  48.     path Reboot: ADD
  49.   OR
  50.   - Drop/Copy the 'Reboot' file in your favorite directory
  51.     (like "Sys:Utilities").
  52.     To copy the (german) catalog files, type
  53.     Copy Catalogs/#? TO="LOCALE:Catalogs/" ALL QUIET CLONE
  54.  
  55. =============================== Usage =====================================
  56. ===========================================================================
  57.  
  58.     NAME
  59.         Reboot -- rebooting utility
  60.  
  61.     FORMAT
  62.         Reboot [REBOOTDELAY <seconds>] [QUIET|NOREQ]
  63.  
  64.     TEMPLATE
  65.         REBOOTDELAY/K/N,QUIET=NOREQ/S
  66.  
  67.     TOOLTYPES
  68.         REBOOTDELAY/N
  69.         QUIET/S
  70.         NOREQ/S
  71.  
  72.     PURPOSE
  73.         To reboot the computer.
  74.  
  75.     SPECIFICATION
  76.         Reboot is used to reboot the whole computer like a "cold"
  77.         system start.
  78.  
  79.         Unless you specify otherwise (through REBOOTDELAY option), reboot
  80.         waits 2 seconds before rebooting the system.
  81.         This is used to let the system (and it's disk drives) settle.
  82.         This delay time can't be less than 1 second, a REBOOTDELAY=0
  83.         will also wait this time.
  84.  
  85.         Whenever the QUIET (or NOREQ) option is set, the verify requesters
  86.         ("Are you sure#?" etc.) will be suppressed.
  87.  
  88.         Test mode / Variable support:
  89.         "Setenv Reboot OFF" or "Set Reboot OFF" will stop Reboot from
  90.         rebooting the system. Instead it will work like when a CTRL_C
  91.         signal or an aborted verify requester occurs.
  92.         This is very useful when testing scripts etc.
  93.         See also in the BUGS section.
  94.  
  95.         Reboot supports workbench multiselect (e.g. project icons) !
  96.  
  97.     BUGS/NOTES
  98.         Setenv Reboot " OFF" (space before OFF switch) currently won't 
  99.         stop rebooting the system.
  100.         Be sure you don't set some rubbish in this variable. If future 
  101.         parsing through dos.libary/ReadArgs() fails, later versions of
  102.         Reboot won't reboot the system.
  103.         Local variables longer than 255 are currently not supported.
  104.  
  105.         "Set Reboot OFF" is only valid if you start Reboot from this
  106.         shell.
  107.  
  108.  
  109. =============================== TODO ======================================
  110. ===========================================================================
  111.   - ReadArgs() parsing of REBOOT variable
  112.   - AmigaGuide document "Reboot.guide"
  113.  
  114.  
  115. ============================== SOURCE =====================================
  116. ===========================================================================
  117. Reboot source and catalogs may be recompiled/reprocessed
  118. (using DICE-C or SAS-C) by executing Reboot.c.
  119.  
  120. I've you like to include a new language (like Français or Nederlands etc.),
  121. send me a filled "Reboot_blank.ct" file named "Reboot_#?.ct" (#? for your
  122. language). As an example, see "Reboot_deutsch.ct".
  123. Note that I can currently only process "Reboot_#?.ct" files whose language
  124. is supported by AmigaOS 3.1 (e.g. a CBM language driver exists).
  125.  
  126.  
  127. =========================== Author's Request ==============================
  128. ===========================================================================
  129. By  releasing  this program I do  not  place any obligations on you,
  130. feel free to share this program with your  friends (and enemies).
  131.  
  132. If you want to blame me, report any bugs, or wants a new version
  133. send your letter to:
  134.                 Roland Mainz
  135.                 Hohenstaufenstraße 8
  136.                 D-52388 Nörvenich
  137.                 GERMANY
  138.  
  139. EMAIL is also available:
  140. If you don't find a file "email.changed" in this archieve,
  141. my email address is:
  142.                 mainz@mats.gmd.de
  143.  
  144.  
  145. The  entire  "Reboot"  package  may  be  noncommercially  redistributed,
  146. provided  that  the package  is always  distributed in it's complete  form
  147. (including it's documentation).  A small copy fee  for media costs is okay
  148. but any kind of commercial distribution is strictly forbidden!
  149. Comments  and  suggestions  how  to  improve  this  program  are generally
  150. appreciated!
  151.  
  152. Thanks to Matt Dillon for his DICE, and Olaf 'Olsen' Barthel for his
  153. help, ideas and some text clips from his documentations.
  154.  
  155.  
  156.  
  157.  
  158.